home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / get25.zip / GET25NEW.DOC < prev    next >
Text File  |  1991-12-01  |  17KB  |  366 lines
  1.   GET25NEW.DOC  -  New features in GET.EXE  -  Copyright 1991 Bob Stephan
  2.  
  3.   This file summarizes the new and improved features in the various 
  4.   releases of GET Version 2 through Release 2.5.  If you have been using 
  5.   an older version of GET, you should read this file to find out what 
  6.   has been changed, and what has been added.  Any items of interest 
  7.   mentioned here are fully described in GET.DOC.  This is merely a 
  8.   brief overview.
  9.  
  10.   Release 2.5:
  11.  
  12.   Release 2.5 is a "bug fix" release.  The /Wdiv feature for GET F to 
  13.   divide a file size by a given divisor that was introduced in Version 
  14.   2.4 did not work as advertised.  This is fixed in 2.5.  Apologies 
  15.   are extended for any inconvenience this may have caused.
  16.  
  17.   Sometimes it is desirable to be able to get the exact size of a 
  18.   small file.  This capability has been added to the GET F file size 
  19.   function in Version 2.5.  It makes use of the /A switch, which can
  20.   be thought of mnemonically as meaning All.  The syntax is:
  21.  
  22.   GET F[E] filespec [/A] [/Wdiv] [/X]
  23.  
  24.   If /A is specified, All the bytes in the file size will be reported
  25.   in the Environment for files up to 655,350 bytes.  If over that size, 
  26.   the value will have an asterisk as the last character indicating that 
  27.   the size is not valid, but that it is larger than 655,350 bytes. If 
  28.   the file is 255 bytes or less, the full size will be in the ErrorLevel.  
  29.   The /Wdiv switch can be used to specify a divisor for larger files so 
  30.   that the resulting ErrorLevel will be less than 255.  The divisor 
  31.   does not affect the Environment variable.
  32.  
  33.   EXAMPLE:
  34.  
  35.   1. Suppose you have a file of exactly 166,816 bytes.  You could see 
  36.   the following results.
  37.  
  38.   GET F filespec
  39.   The Environment is: 163
  40.   The ErrorLevel is: 163
  41.  
  42.   GET F filespec /A
  43.   The Environment is: 166816
  44.   The ErrorLevel is: 255
  45.  
  46.   GET F filespec /A /W1000
  47.   The Environment is: 166816
  48.   The ErrorLevel is: 166
  49.  
  50.   GET F filespec /A /W1000 /X
  51.   The Environment is: 28BA0
  52.   The ErrorLevel is: 166
  53.   ------------------------------------------------------------------
  54.   Also, a page back feature has been added to the help screen.  
  55.   Displaying the help screen by simply entering GET will now pause at 
  56.   the end of the second screen with the message
  57.  
  58.   Press PgUp to repeat the first screen - Esc, CR, or space bar to exit
  59.  
  60.   Pressing PgUp at this point will start the help screen display over 
  61.   again.  Pressing CR (Enter or Return on the keyboard) will exit and
  62.   clear the screen giving you a clear screen to work on.  Pressing Esc 
  63.   or the space bar will exit and leave the second help screen on the 
  64.   display for reference.  The pause will time out in 10 seconds and 
  65.   return to the DOS prompt automatically.
  66.  
  67.   A useful utility has been added to the GET package.  RUN.EXE will 
  68.   run any .COM or .EXE file and report the ErrorLevel it returns.  
  69.   Previously many of us had a large BATch file that went something
  70.   like:  IF ERRORLEVEL 255 SAY 255
  71.          IF ERRORLEVEL 254 SAY 254
  72.          ...
  73.          IF ERRORLEVEL 1 SAY 1
  74.  
  75.   where SAY.BAT simply echoed its argument.  This was slow and 
  76.   cumbersome.  RUN can greatly speed up the process of testing 
  77.   programs for return codes.  See RUN.DOC for further details.
  78.  
  79.   Finally, a different method of compressing the .EXE file is being 
  80.   used.  It compresses the licensed runtime version, GETRUN.EXE, to 
  81.   under 4K, so GETNOT is no longer needed and will not be included
  82.   in licensed copies.
  83.  
  84.   Release 2.4:
  85.  
  86.   GET.EXE Release 2.4 contains only a few changes from Release 2.3. 
  87.   There are no bug fixes (none have been reported in 2.3) so if you 
  88.   don't need any of the new features, you can continue to use 2.3 with 
  89.   confidence.
  90.  
  91.   There were a very few reports of an apparent ROM BIOS incompatibility 
  92.     with one or two different systems which involved the method of 
  93.     displaying the prompt in 2.3.  The method was changed from Version 
  94.     2.2 to permit displaying the prompt in color or reverse video even 
  95.     with ANSI.SYS loaded.  It is now changed again to try to fix this 
  96.     BIOS incompatibility that so far has appeared only rarely.
  97.     Due to the most recent method now being used in Version 2.4, the 
  98.     maximum prompt length has to be limited to 79 characters if /A is 
  99.     used.  The "prompt" can also be used to send ANSI.SYS escape 
  100.     sequences to the screen.  See information on the /A switch below.
  101.  
  102.   GET R for 'Rithmetic - add or subtract two numbers. 
  103.     Syntax:  GET R[E] [num1] [/Wnum2]
  104.   
  105.   Input:  One or two numbers for arithmetic
  106.  
  107.   Process:GET R adds the two numbers
  108.           GET RE subtracts the second from the first
  109.  
  110.   Output: Arithmetic result in Environment and ErrorLevel
  111.           If only one number is given, the other number defaults to 0.  
  112.           Max number of digits for each number is 4.
  113.           Thus a character representation of a number can be converted
  114.             to a number in the ErrorLevel.
  115.           Example: A loop counter
  116.                    SET COUNT=0
  117.                    :LOOP
  118.                    GET R %COUNT% /W1 /VCOUNT=
  119.                    Echo The count is %COUNT%
  120.                    IF NOT ERRORLEVEL 10 GOTO LOOP
  121.           If the result is greater than 255, the ErrorLevel is modulo 256.
  122.              256=0, 257=1, ..., 511=255, 512=0, etc.
  123.           No negative numbers are recognized.  If a larger number is 
  124.           subtracted from smaller, the result is the difference + 65536.
  125.            Example: GET RE 10 /W20
  126.                     The ErrorLevel is 246
  127.                     The Environment is 65526
  128.  
  129.   SWITCHES:
  130.  
  131.   /A if the /A switch is not included, the prompt will be displayed 
  132.      in such a manner that ANSI sequences can be used for screen 
  133.      control.  This restores compatibility with Version 2.2 for 
  134.      prompting and using ANSI screen control sequences.  The "prompt"
  135.      will always be sent to the screen even if standard output is 
  136.      redirected with DOS redirection (>).  Without /A the prompt can 
  137.      be as long as will fit on the DOS command or BATch line which is 
  138.      limited to 128 characters total.  With /A, the prompt is limited 
  139.      to 79 characters.
  140.  
  141.   /T TRIM switch for GET S, GET Z, and GET HE.  
  142.          /TL or /T- will trim leading blanks.
  143.          /TR or /T+ will trim trailing blanks.
  144.              
  145.   /V- will suppress creation of the Environment variable completely.  
  146.      A side effect of /V- is that SET GET?=ON will have no effect.  
  147.      Since the search of the Environment is being completely bypassed, 
  148.      GET will not be able to check for the GET? variable.
  149.  
  150.   Two additions to the GET F command:
  151.  
  152.   /X Previously GET F always put the filesize in the Environment in 
  153.      hexadecimal.  Now it will be in decimal kilobytes, unless the /X 
  154.      for heX switch is included in which case it will be the full 
  155.      size in hex as before.
  156.  
  157.   A divisor can be provided for the GET F file size command similar to
  158.     the divisors permitted for GET K and GET Q.
  159.  
  160.     Syntax:  GET F filespec /Wnum
  161.  
  162.   NOTE: The use of GET F to test for the existence of a directory is 
  163.     valid only for subdirectories, and not for any root directory.
  164.     Since DOS does not recognize the root directory as a file, commands
  165.     such as GET F \, GET F c:\, GET F c:, etc. are not valid.  Also, 
  166.     if there is an error (no Environment variable) and the ErrorLevel 
  167.     is 15 it means that an invalid drive was specified.  These items 
  168.     were true in previous versions of GET, but were not described 
  169.     completely in the documentation.  Also, although it is a 
  170.     documented procedure in MS DOS 5.0, do not use the NUL device to 
  171.     check for a directory if any users might be using DR DOS 5.0.  DR 
  172.     DOS 5 thinks that the NUL (and other) devices exist even in 
  173.     non-existent directories.  It may be that a few other versions of
  174.     DOS do not support the NUL device method of checking, but GET will
  175.     work with them all.
  176.  
  177.   There is a minor improvement to the GET UE command.  Previously the 
  178.       value place